This sample is designed to show the proper use of the the new flags (Mac OS 9+ and the iBooks, slot loading iMacs and AGP Graphics G4 PowerMacs) in the NewGWorld routine. The application draws a re-sizable window that is updated from an offscreen GWorld. The user has control over where to allocate the GWorld's PixMap data (in VRAM, in AGP memory or in system memory). A blitting test can then be performed to test blitting speed using CopyBits.
The application checks the offscreen in relationship to the window during execution to ensure that it is still viable. The checks include looking for a NULL GWorld, a NULL PixMap, a NULL PixMap base address, non-matching window and GWorld GDevices, and non-matching window and GWorld color depths. If any of these are true the GWorld is reallocated. The user can see this reallocation with a color change in the window. The application will also check the operating system (Mac OS 9.0 or later) and/or the boot ROM () at start for use of allocations in VRAM and AGP memory. On older systems setting the new flags is ignored and the NewGWorld Pixmap data allocation will take place in system memory.
See Technote TN1182: "NewGWorlds in VRAM and AGP Memory" for further technical details about the new version of NewGWorld at: <http://developer.apple.com/technotes/tn/tn1182.html>
Requirements: Building this project requires CW2 and Universal Headers 3.3.
